home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / bbs / multi207 / multi.doc < prev    next >
Encoding:
Text File  |  1994-03-19  |  7.2 KB  |  174 lines
  1. MULTI.EXE, server for FBB-BBS.
  2. (By LA6CU, Per)
  3.  
  4. This server is used to send personal copies of special messages.  The 
  5. original is adressed to a special "call", and then there is automatically
  6. made personal copies to everyone that shall have one.
  7.  
  8. MULTI may work in 2 ways.  You may use one of them, or both.  I use both at
  9. the same time.
  10.  
  11. 1:  WITH DAT-FILES:
  12. -------------------
  13.  
  14. Installation:
  15.  
  16. MULTI.EXE is put in the same directory as SERV.EXE.   MULTI will read from
  17. INIT.SRV...
  18.  
  19. In INIT.SRV, MULTI is included together with REQFIL, REQDIR etc.  Example:
  20. #
  21. ------
  22. #
  23. REQFIL  REQFIL
  24. REQDIR  REQDIR
  25. KLUBB   MULTI
  26. TEST    MULTI
  27. #
  28.  
  29. In this example all messages sent to
  30. SP KLUBB
  31. will be copied to all callsigns in the file KLUBB.DAT, while messages sent to
  32. SP TEST
  33. will be copied to all callsigns in the file TEST.DAT.
  34.  
  35. KLUBB.DAT and TEST.DAT (in this example) must stay in the FBB-directory.
  36. You must make one such .DAT-file for every to-field you define in INIT.SRV.
  37.  
  38. The .DAT-files must consist of callsigns (@BBS and H-adresses allowed) for 
  39. all those that shall have a copy.
  40.  
  41. There are 4 different copy-types.
  42. A (action)      :  This is the callsign that will receive the message, or
  43.                    perform the action described in the message.
  44. C (copy)        :  This callsign receives a copy of the message.
  45. I (information) :  This callsign receives a copy for information.
  46. H (hidden)      :  This callsign receives a copy, but his callsign will not
  47.                    appear in the footnotes of the message, telling who has
  48.                    received a copy.
  49.                    
  50. There may be more than one callsign on each line (starting with A, I, C or H)
  51. seperated by a comma.  There may be maximum 100 callsigns altogether.  
  52. Comment-lines are extras, they MUST start with a #
  53.  
  54. Example of KLUBB.DAT:
  55.  
  56. A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
  57. A LA6GDA                    <-----    "     "   "   "    "     "     "
  58.                                     May be several lines if there is not 
  59.                                     enough room in one line. 
  60. I LA5RBA                    <-----  LA5RBA is informed on the matter
  61. C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
  62.                                     node-lists
  63. H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
  64.                                     in the list of callsigns at the end of
  65.                                     each message.
  66.  
  67. Beware:  The .DAT-files shall consist of callsigns and comments, nothing 
  68.          else !  No /EX, no * and no *** end of file.
  69.  
  70. MULTI will NOT send a copy back to the originator, even if he also is in
  71. the .DAT-file.  This to avoid "looping" of messages.
  72. MULTI will send an acknowledge-message back to the originator, telling 
  73. him that the copying was successful, and show him a list of all callsigns
  74. that will receive such a copy.
  75.  
  76. R:lines on incoming messages are removed, untill there has arrived 2 lines
  77. without R:  After that. R:lines are accepted again.  This is done to make it
  78. possible also to forward messages back the same route, and at the same time
  79. make it possible to include R:lines in the message itself.
  80.  
  81. R:lines are NOT checked to prevent forward to BBSs that are already in
  82. these R:lines, because a message to a MULTI-server only will be processed
  83. at the end-BBS anyway.
  84.  
  85. MULTI needs very little memory (I have not checked how much..), but I have
  86. been told that it needs less than 35k.  MULTI does not write to screen.
  87.  
  88. MULTI.EXE must be in the same directory as SERV.EXE, while the .DAT-files 
  89. must be in the same directory as INIT.SRV.  MULTI gets all data it needs 
  90. from INIT.SRV and the .DAT-files.
  91. MULTI makes a temporary file MULTI.TMP on disk, and delete it afterwards.
  92. Everything else is done in memory, and the result is placed in MAIL.IN, as
  93. all servers do.
  94.  
  95.  
  96. 2:  WITH ALL CALLSIGNS DIRECTLY IN THE ORIGINAL-MESSAGE.
  97. --------------------------------------------------------
  98.  
  99. MULTI still works exactly as before, with the same installation.  But after
  100. a request from F6ABJ and F6FBB I have made a modification so that users
  101. themselves can decide what callsigns will receive a copy.  This is done
  102. by including the callsigns in the message itself.
  103.  
  104. In INIT.SRV, MULTI is still included like bfore (see further up).  But
  105. in addition, you now must have 1 extra line, like this:
  106.  
  107. #
  108. ------
  109. #
  110. REQFIL  REQFIL
  111. REQDIR  REQDIR
  112. KLUBB   MULTI
  113. TEST    MULTI
  114. MULTI   MULTI               <----  This line is new.
  115. #
  116.  
  117. It is very important to use the word MULTI here, nothing else will work.
  118.  
  119. Users will now be able to send messages to MULTI, like this:
  120. SP MULTI     The program will now collect the info on who will receive a 
  121. copy, from the message itself, and not from a seperat .DAT-file like 
  122. SP KLUBB or SP TEST still will do.
  123.  
  124. There are 4 different copy-types.
  125. A (action)      :  This is the callsign that will receive the message, or
  126.                    perform the action described in the message.
  127. C (copy)        :  This callsign receives a copy of the message.
  128. I (information) :  This callsign receives a copy for information.
  129. H (hidden)      :  This callsign receives a copy, but his callsign will not
  130.                    appear in the footnotes of the message, telling who has
  131.                    received a copy.
  132. (In addition one may use CC: instead of only C for Copy.  Special request..)
  133.  
  134. There may be more than one callsign on each line (starting with A, I, C or H)
  135. seperated by a comma.  There may be maximum 100 callsigns altogether.  
  136. Comment-lines are extras, they MUST start with a #
  137.  
  138. Example:
  139. SP MULTI
  140. Digipeater upgrade          <-----  Title of message
  141. A LA6CU, LA1B, LA2D         <-----  Copies to the people doing the job
  142. A LA6GDA                    <-----    "     "   "   "    "     "     "
  143. I LA5RBA                    <-----  LA5RBA is informed on the matter
  144. C LA6IM @ LA6IM             <-----  LA6IM receives a copy for updating his
  145.                                     node-lists
  146. H LA2GIA                    <-----  LA2GIA receives a copy, but will not appear
  147.                                     in the list of callsigns at the end of
  148.                                     each message.
  149. ---------                   <-----  After the last callsign, there must be a
  150.                                     string of at least 5 '-' before the
  151.                                     actual message.
  152.                                     
  153. Then follows the contents of the message, and end with Ctrl-Z or /EX.
  154.  
  155. As ususal, the sender will receive a message saying that the copies were
  156. made.  The messages to all the other calligns will be identical, and look
  157. like this:
  158.  
  159. Message via LA6CU MULTI-server (v2.03) :
  160.  
  161. Contents of message
  162.  
  163. ============================================================================
  164. For action       : LA6GDA, LA6CU, LA1B, LA2D.
  165. For copy         : LA6IM.
  166. For information  : LA5RBA.
  167. ============================================================================
  168.  
  169. All copies are identical, but A, C and I determines in which line in the
  170. footnotes the callsigns will appear.  A callsign after an H will not 
  171. appear in the footnotes.
  172.  
  173. 73 de Per, LA6CU.
  174.